home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / HDOS14.ARJ / README.DOC < prev    next >
Text File  |  1992-08-10  |  15KB  |  318 lines

  1.   ════════════════════════════════════════════════════════════════════════════
  2.                     The 'HandyDOS' Utilities - (C) 1992
  3.                             All Rights Reserved.
  4.   ════════════════════════════════════════════════════════════════════════════
  5.        Abri Technologies, Inc., HCR62 Box 100K, Cacapon, WV 25422 USA
  6.   ════════════════════════════════════════════════════════════════════════════
  7.                              ┌───────┐
  8.                         ┌────┴──┐    │               (Tm)
  9.                       ──┤       │o   ├───────────────────
  10.                         │  ┌────┴──┐ │  Association of
  11.                         │  │       ├─┘  Shareware
  12.                         └──┤   o   │    Professionals
  13.                       ─────┤   ╥   ├────────────────────-
  14.                            └───╨───┘    MEMBER
  15.  
  16.  
  17.  SHAREWARE INFORMATION:
  18.      This is Shareware and not Public Domain Software. Examine this free for 
  19.      30 days and if you find it useful please send $25 registration fee to the 
  20.      above address. When you register you will receive all updates, additions
  21.      and latest corrections and software support for a minimum of three months.
  22.      We strive to continually improve the current utilities and to add handy
  23.      new ones, so it will be worth your while to register. Suggestions for
  24.      "HandyDOS" additions are welcome.
  25.  
  26.      ** Please read the shareware agreement near end of this file and the
  27.      Registration/Ordering form in file REGISTER which also contains
  28.      information on other software available from ATI.
  29.      
  30.  INTRODUCTION: (Version 1.4)
  31.      HandyDOS resulted from a need for several handy utilities which are 
  32.      absent in DOS. The purpose was to improve users' time efficiency and 
  33.      disk use without nonessential frills frequenting multipurpose menu 
  34.      programs - which often require several steps for a simple task.
  35.  
  36.      The objects in mind when designing the software were in order of 
  37.      importance: effectiveness, minimum keystrokes for the job, 
  38.      ease-of-use/intuitiveness and small program size. Most software should 
  39.      not try to be impressive but just do the job efficiently and get out 
  40.      of the way.
  41.      
  42.      Version 1.4 adds ATTRB.EXE a very intuitive and easy-to-use full 
  43.      screen file attribute utility.
  44.  
  45.  COMPUTER REQUIREMENTS: 
  46.      The software uses little memory and should run on any DOS 2.1 and up.
  47.  
  48.  FILES INCLUDED: 
  49.  
  50.      INSTALL.BAT  README.DOC (this file)  REGISTER
  51.  
  52.      BAK.EXE      0.EXE       MV.EXE      DELTREE.EXE    D.EXE
  53.      VMODE.EXE    ATTRB.EXE   INPUT.EXE   ECH.EXE
  54.  
  55.  INSTALLATION:
  56.      The software should be installed in a DOS path - usually C:\DOS.
  57.  
  58.      You can use the INSTALL.BAT which creates a directory on a hard disc 
  59.      and copies the software to the directory. 
  60.  
  61.      Alternatively, at any time you can copy the software files from 
  62.      diskette to a directory:
  63.  
  64.      Example:   COPY A:*.* C:\DOS
  65.  
  66.  DESCRIPTION OF PROGRAMS:
  67.      NOTE: All programs will give USAGE summary information with the
  68.      /? switch, as is common for DOS 5.0.
  69.  
  70.   a. BAK.EXE and 0.EXE
  71.      These programs can delete all .BAK extension and zero length files
  72.      in a directory and all subdirectories. They are about as fast as the DOS5
  73.      "DIR *.BAK /S" is in finding the files.
  74.      
  75.  
  76.      BAK USAGE:       bak [directory] [/S]
  77.      
  78.      0 USAGE:         0 [directory] [/S]
  79.  
  80.      If /S is used, all subdirectories are searched.
  81.           
  82.      [directory] can be omitted for current directory.
  83.      
  84.      NOTE: BAK and 0 do not delete files with system or hidden attributes.
  85.  
  86.   b. MV.EXE
  87.      This program can rename or move any file or directory to anywhere
  88.      else on the disc.     
  89.      USAGE:        MV OldPath NewPath [/O]
  90.      
  91.      OldPath can have wild card '*' chars for file transfer only.
  92.      
  93.      Switch /O will overwrite existing NewPath files/directories.
  94.  
  95.      NOTES: (I) A directory cannot be moved into its subdirectory. (II) 
  96.      MV does not transfer directories from one drive to another - for that
  97.      use XCOPY /S and DELTREE (included here).
  98.      
  99.   c. DELTREE.EXE
  100.      This program deletes any directory with its subdirectories and all
  101.      files. 
  102.      
  103.      USAGE:     DELTREE directory
  104.      
  105.      Any valid directory can be specified. If the current directory is 
  106.      specified it will be deleted and the next upper directory will become 
  107.      the current directory.
  108.      
  109.      NOTE: Before deleting directories on floppies, it will save time if the 
  110.      DOS verify is OFF, since each deletion has to be read verified if
  111.      verify is ON. On hard drives the delay is less noticeable.
  112.  
  113.      Some uses of Deltree:
  114.    * handy for cleaning up the drive of stale software or moving
  115.      it to another drive in conjunction with the XCOPY /S command.
  116.    * an alternative to formatting a floppy to erase all the files/directories. 
  117.    * deleting old backup files on floppies.
  118.    * defragmenting a hard drive without reformatting. After backing up all
  119.      your disk files use deltree (example: deltree c:\) to delete all files
  120.      and then RESTORE the files back on the drive.
  121.      
  122.   d. D.EXE
  123.      You will find this utility a real time saver. With a simple number 
  124.      reference (0-99) you can find your way around DOS drives/directories 
  125.      and execute programs without complicated menu software. 
  126.      
  127.      USAGE:            ACTION:
  128.      
  129.       D +# [program]   Sets jump point # to current drive and directory with 
  130.                          optional [program] execution.
  131.       D # [program]    Jumps to directory # and optionally executes [program]
  132.       D -#             Deletes jump point # from list
  133.       D                Lists jump points
  134.       D /?             Lists this info      
  135.              # is any number 0 to 99
  136.  
  137.      EXAMPLES:
  138.      
  139.      d +9               adds the current directory as #9 on the jump list.
  140.      
  141.      D +12 GWBASIC MENU   (adds current directory as #12 to jump list with
  142.                                    GWBASIC to execute MENU.BAS program.)
  143.      
  144.      D 12               (will jump to directory associated with #12 on list
  145.                                 and execute GWBASIC MENU combination)
  146.      
  147.      d 9                (will jump to directory associated with #9 on list)
  148.      
  149.      D -12              (will remove directory/program reference from list)
  150.      
  151.      Some Uses of D:
  152.    * It can be used by different users to "logon" their directories and/or 
  153.      start programs. 
  154.    * Frequently, PC users will add the command "CD directory" to the 
  155.      AUTOEXEC.BAT file to go to a particular directory at bootup. This can 
  156.      be now changed to "D #", the # representing a directory (and optional 
  157.      program execution) on the jump list. Subsequent changes can be simply 
  158.      done using D +# [program] without editing the AUTOEXEC.BAT file. 
  159.    * The program execution feature can be a substitute for DOS menu 
  160.      programs. When the optional program is specified for execution, the D 
  161.      program releases all DOS memory to that program (except about 3k for
  162.      batch programs).
  163.      
  164.      Notes: 
  165.         The first time D is executed it establishes an ascii jump list
  166.         file "D.DDD" in the same directory as D.EXE".
  167.         
  168.         Some packed programs (Example: QBASIC) may not execute when called 
  169.         directly by D.EXE. If you find this to be true you can get around 
  170.         this by prefixing the program name with the command.com pathname 
  171.         and the /C switch. Example: "D +23 C:\COMMAND /C QBASIC" instead of 
  172.         "D +23 QBASIC".
  173.      
  174.   e. VMODE.EXE
  175.      This program can set or find the current video mode and graphics
  176.      capabilities of the video card. It also indicates the corresponding
  177.      GW/QBASIC SCREEN numbers used by BASIC programmers.
  178.      
  179.      The program is handy for laptop users to get the large █ block cursor 
  180.      and find the best video text mode for greatest contrast. For example, 
  181.      The Leading Edge DLT/386SX default is 3, but the best contrast is with 
  182.      video mode number 7. Thus an AUTOEXEC.BAT command "VMODE 107" will set
  183.      the block cursor and best contrast at bootup.
  184.  
  185.      USAGE:              COMMENTS:
  186.  
  187.      VMODE              to display current video mode
  188.      VMODE # [add 100]  to set video mode # [and get █ cursor]
  189.      VMODE /A           to display all video mode #'s
  190.      VMODE /I           to invert video text mode
  191.      
  192.      Notes: The █ is available only for text modes. Some software will
  193.               change to default "_" DOS cursor when exiting.
  194.             VMODE returns DOS errorlevel 1 with an error message and 0
  195.               otherwise.
  196.  
  197.   f. ATTRB.EXE
  198.      This program is meant to replace the awkward dos ATTRIB utility.
  199.      It is an easy-to-use WYSIWYG full-screen utility for changing file
  200.      attributes - to/from ReadOnly, Hidden, System and Archive modes (RHSA).
  201.      
  202.      USAGE:   ATTRB [FileSpec]
  203.      
  204.      FileSpec can be general like *.* or a specific filename. If not given
  205.      the default FileSpec is *.*. To change FileSpec on screen press the
  206.       key when  appears beside "Files spec:" and then type in new file 
  207.      spec.
  208.  
  209.      The R, H, S or A attributes for a highlighted file are changed simply 
  210.      by pressing one of the RHSA keys. Pressing the Alt key and one of the 
  211.      RHSA at same time changes attributes for all files specified - except 
  212.      directories, which can only be changed individually.
  213.  
  214.   g. INPUT.EXE & ECH.EXE
  215.      These are simple programs but can be very useful in writing batch files.
  216.      Even DOS5 still does not facilitate direct batch menu selection. This
  217.      program pair fixes this need.
  218.      
  219.      INPUT USAGE:
  220.      
  221.      INPUT [/F] string1 string2 string3 .....
  222.      
  223.      The program gets keyboard input and returns to DOS the number (#) of 
  224.      the character string matching the input (i.e. returns 1 if string1 is 
  225.      same as the keyboard input, 2 if string2, etc.). A zero is returned if 
  226.      no match is found. The number returned is called the errorlevel - but 
  227.      is really not an error here. Upper/lower case character differences 
  228.      are ignored. If switch /F is used, only one character is accepted from 
  229.      the keyboard which is then compared to only the first character of 
  230.      each string. INPUT /F is a good substitute for the dos PAUSE command
  231.      since it doesn't interrupt with 'Press any key to continue ...' or
  232.      add an extra <CR><LF>.
  233.      
  234.      ECH USAGE:         ECH string
  235.      
  236.      This command is similar to the DOS echo but does not add a <CR><LF>
  237.      pair - i.e. it does not move the cursor to next line. This is
  238.      useful in batch menu programs when you want the cursor to stay beside
  239.      the "question".
  240.      
  241.      If the string has spaces ECH will reduce all spaces to a single
  242.      space. If you wish an exact string echo use quotation marks around
  243.      the whole string. Example:
  244.      
  245.      ECH "Do you wish to make a selection?      (y/n) "
  246.      
  247.      A sample batch file program is listed below. Note the sequence of
  248.      the errorlevel tests. Make sure you understand how DOS responds
  249.      to errorlevels of programs - see DOS manual.
  250.  
  251.      ----------------------------------------
  252.      @echo off
  253.      echo .
  254.      ech Do you wish to select programs? .
  255.      input yes y oui
  256.      if errorlevel 1 goto programs
  257.      goto end
  258.      :programs
  259.      cls
  260.      echo A Word Processing
  261.      echo B Invoicing
  262.      echo C Modem
  263.      echo .
  264.      ech "     " Press a selection letter (A/B/C)
  265.      input /f a b c
  266.      if errorlevel 3 C:\USR\COM\MODEM
  267.      if errorlevel 2 C:\BUS\INVCX5
  268.      if errorlevel 1 C:\WS5\WS
  269.      :end
  270.      ----------------------------------------
  271.      
  272.  DISCLAIMER and SHAREWARE - AGREEMENT:
  273.      Users of HandyDOS must accept this disclaimer of warranty: HandyDOS is 
  274.      supplied as is.  The author disclaims all warranties, expressed or 
  275.      implied, including, without limitation, the warranties of 
  276.      merchantability and of fitness for any purpose. The author assumes no 
  277.      liability for damages, direct or consequential, which may result 
  278.      from the use of HandyDOS."
  279.  
  280.      HandyDOS is a "shareware software" and is provided at no charge to the 
  281.      user for evaluation.  Feel free to share it with your friends, but 
  282.      please do not give it away altered or as part of another system.  The 
  283.      essence of "user-supported" software is to provide personal computer 
  284.      users with quality software without high prices, and yet to provide 
  285.      incentive for programmers to continue to develop new products.  If you 
  286.      find this program useful and find that you are using HandyDOS and 
  287.      continue to use HandyDOS after a reasonable trial period, you must 
  288.      make a registration payment of $25 to Abri Technologies.  The $25 
  289.      registration fee will license one copy for use on any one computer at 
  290.      any one time.  You must treat this software just like a book.  An 
  291.      example is that this software may be used by any number of people and 
  292.      may be freely moved from one computer location to another, so long as 
  293.      there is no possibility of it being used at one location while it's 
  294.      being used at another. Just as a book is not read by two different 
  295.      persons at the same time.
  296.  
  297.      Commercial users of HandyDOS must register and pay for their copies of 
  298.      HandyDOS within 30 days of first use or their license is withdrawn.  
  299.      Site-License arrangements may be made by contacting Abri Technologies.
  300.  
  301.      You are encouraged to pass a copy of HandyDOS along to your friends 
  302.      for evaluation.  Please encourage them to register their copy if they 
  303.      find that they can use it.  All registered users will receive a copy 
  304.      of the latest version of HandyDOS and software support for a minimum
  305.      of three months after registration.
  306.      
  307.      For registration and software ordering view the 'REGISTER' file.
  308.  
  309.     "This program is produced by a member of the Association of Shareware
  310.     Professionals (ASP).  ASP wants to make sure that the shareware
  311.     principle works for you. If you are unable to resolve a
  312.     shareware-related problem with an ASP member by contacting the member
  313.     directly, ASP may be able to help. The ASP Ombudsman can help you
  314.     resolve a dispute or problem with an ASP member, but does not provide
  315.     technical support for members' products.  Please write to the ASP
  316.     Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe
  317.     message via CompuServe Mail to ASP Ombudsman 70007,3536."
  318.